Skip to content

docs: Add executor readiness gating to /v1/ready endpoint#1733

Merged
lukekim merged 1 commit into
trunkfrom
docs/ready-executor-gating
May 18, 2026
Merged

docs: Add executor readiness gating to /v1/ready endpoint#1733
lukekim merged 1 commit into
trunkfrom
docs/ready-executor-gating

Conversation

@claudespice
Copy link
Copy Markdown
Collaborator

Summary

  • Add min_ready_executors, min_ready_executors_percent, and verbose query parameters to the /v1/ready endpoint in the OpenAPI spec and generated API docs
  • Document the 400 response code for invalid parameters or executor gates requested outside scheduler role
  • Add Kubernetes readiness probe example with executor gating

Source PRs

Changes

  • website/public/openapi.json — Added query parameters and 400 response to /v1/ready endpoint
  • website/docs/api/HTTP/ready.api.mdx — Regenerated from updated spec with executor gating description and examples
  • website/docs/api/HTTP/ready.*.json — New parameter/schema/status JSON files for the ready endpoint

Test plan

  • cd website && npm run build passes locally (Docusaurus throws on broken links and undefined frontmatter tags)
  • Links are valid
  • Version references are correct

Update OpenAPI spec and API docs for the new /v1/ready query parameters
that gate readiness on executor availability in distributed (scheduler) mode:
min_ready_executors, min_ready_executors_percent, and verbose.
@claudespice claudespice self-assigned this May 18, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 18, 2026

✅ Pull with Spice Passed

Passing checks:

  • ✅ Title meets minimum length requirement (10 characters)
  • ✅ Has at least one of the required labels: area/blog, area/docs, area/cookbook, dependencies
  • ✅ No banned labels detected
  • ✅ Has at least one assignee: claudespice

@github-actions
Copy link
Copy Markdown

🚀 deployed to https://ca3ec5b0.spiceai-org-website.pages.dev

@lukekim lukekim merged commit d2bcc16 into trunk May 18, 2026
6 of 9 checks passed
@lukekim lukekim deleted the docs/ready-executor-gating branch May 18, 2026 18:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants